Ein blitzkurzer Infotext zu THE_CIRCLE: ======================================= Mit Hilfe von THE_CIRCLE ist es m”glich, im MausTausch-Frontend THE_DOT von Jochen Herz (Hi NUNZ!) Serienmails (z.B. fr Einladungen oder sowat) zu verschicken. Solche Schreiben nennt man auch Rundschreiben und weil das rundeste, was man sich vorstellen kann (von mir abgesehen), ein Kreis ist, heižt das Ganze THE_CIRCLE. Schubidu. In THE_DOT wird seit der Version 2.11 eine Schnittstelle zu THE_CIRCLE zur Verfgung gestellt: Im Men "Programme" gibt es den Menpunkt "zu CIRCLE...". Bei dessen Anwahl wird im MODULE-Ordner nach CIRCLE.PRG gesucht und bei Erfolg gestartet. Als Parameter wird der komplette Pfad des momentan in THE_DOT eingestellten INF-Files bergeben. Aus diesem entnimmt THE_CIRCLE Informationen ber die Message- und Workordner-Struktur. Die vorliegende Version ist inzwischen 1.0 und sie hat weniger Fehler als die 0.99. Unter Umst„nden kommt es natrlich nach wie vor zu nicht ganz narren- sicheren Komfortproblemen und Runtime-Fehlern wegen eventuell nicht gefundener Dateien oder Pfade. Da ich's aber trotzdem ver”ffentlicht habe, ist jeder, der THE_CIRCLE benutzt, hiermit hochoffziell zum THE_CIRCLE-Tester ernannt. THE_CIRCLE IST TAFEL_SCHOKOLADE_WARE! Jeder, der's mal benutzt, und dem's gef„llt, nehme eine 200er Briefmarke und klebe sie auf eine Tafel Schokolade seiner Wahl. Wenns eine ist, fr die man eine 300er Marke braucht, umso besser! Dann noch meine Adresse drauf (steht auch in jedem CoNnect-Handbuch): Philipp Oelwein Ringelsgasse 22 a 69226 Nužloch Maus: Philipp Oelwein @ HD Philipp Oelwein @ LU und in den Briefkasten mit der ganzen Geschichte. Ich versichere hiermit meinen ewigen Dank. WARNUNG: Keine Haftung fr Software oder Hardwaresch„den jedweder Art, die durch THE_CIRCLE eventuell hervorgerufen wurden! Das Programm arbeitet direkt in der SENDEN-Messagebase, und wenn man groben Unfug baut (man muž sich dafr aber schon sehr anstrengen, mehr dazu siehe unten), ist das SENDEN-Brett nicht mehr lesbar und auch nicht mehr crunchbar. In dem Fall SENDEN.IDX und SENDEN.DBS in den Mlleimer und ausgehende Mail neu schreiben. Kurz zur Bedienung: Normalerweise wird man THE_CIRCLE von THE_DOT aus aufrufen (Men "Programme", Punkt "Zu CIRCLE..."). THE_CIRCLE erwartet, im MODULE-Ordner von THE_DOT zu liegen und versucht, im INTERN-Ordner von THE_DOT das THE_DOT-Konfigurationsfile THE_DOT.INF zu laden. THE_CIRCLE versucht, seine eigene Resourcedatei im aktuellen Pfad, im MODULE-Ordner ind im INTERN-Ordner zu finden und zu laden. Wenn irgendetwas von dieser Ordnerstruktur nicht vorliegen sollte und THE_CIRCLE auch mit seinen gewieften und ausgeklgelten Suchroutinen die Strukturen auch nirgendwo anders findet - rumms - Runtime Error 2 ;*) THE_CIRCLE kann natrlich auch "stand-alone" gestartet werden. Als Parameter kann, wie gesagt ein Pfad eines DOT-INF-Files bergeben werden. Ohne Parameter wird als INF-File THE_DOT.INF angenommen. Sollte ein ungltiger Pfad bergeben werden, oder sonstwie eine Datei nicht gefunden werden, erscheint eine Fileselectorbox, in der man ein INF-File ausw„hlen kann. Wenn aber doch alles da ist, entnimmt THE_CIRCLE daraus, wo sich der Pfad fr die Dateien SENDEN.DBS und SENDEN.IDX befindet. Dort werden sp„ter die Serienmails hingeschrieben. Weiter wird aus dem THE_DOT.INF der jeweilige WORK- Pfad entnommen. THE_CIRCLE wird erstmal annehmen, daž sich dort die zwei Dateien mit a) dem Serienbrieftext MAILTEXT.TXT und b) der Empf„ngerliste ADRESSEN.TXT befinden. Wenn das nicht der Fall sein sollte - auch nicht schlimm, das ist einer der F„lle, wo ich den File_Not_Found rechtzeitig abgefangen habe (glaub' ich jedenfalls...) und die Dateien, in denen sich diese Infomationen befinden, sind ohnehin frei konfigurierbar. Anyway. Nun kommt der Bedienungsdialog auf dem Bildschirm - er besteht aus drei Zeilen mit Pfadinformationen und einer Editzeile fr den Betreff der Serienmail. 1. Der Messageordner ist der, den THE_CIRCLE aus dem INF-File von THE_DOT erhalten hat und in dem sich die SENDEN-Files befinden sollten. Diese Zeile kann zwar ge„ndert werden, das ist aber ziemlich obsolet - was in THE_DOT.INF steht, muž ja irgendwie schon stimmen, ein Artefakt aus CIRCLE- Versionen < 0.35. Vielleicht mach' ich das mal raus. 0.96: Žndern kann man ihn nun nicht mehr, aber er ist noch da... 0.98: Jetzt ist er weg und von den folgenden Numerierungen ist jeweils ein Offset von 1 (eins) zu subtrahieren: 2. Der Mailtext ist die Datei, deren Inhalt als gleichlautende Mail an alle Empf„nger geht. Ein simpler ASCII-Text. Voreingestellt ist WORK\MAILTEXT.TXT, aber die Zeile kann ge„ndert werden, entweder "von Hand" oder durch Mausklick, w„hrend man sich mit dem Mauscursor dort befindet. Dann geht ein Fileselector auf, der auf die Extension TXT voreingestellt ist, und mit dem man eben die Textdatei ausw„hlen kann, die als Mail gesendet werden soll. Irgendwelche Platzhalter oder Makros innerhalb des Textes wie "Liebe[%Sex] [%Anrede] [%Receiver]! Heute am [%Date] um [%Time] blablabla.." sind *nicht* vorgesehen! Serienbriefe sollen gleich lauten! Howgh! 3. Die Adrežliste ist ebenfalls eine ASCII-Datei, in der pro Zeile ein Empf„nger steht und zwar in einem Format, wie es die MAUS als Empf„ngeradresse verarbeiten kann - einfach das gleiche, was man sonst "von Hand" in die Empf„nger- zeile eintragen wrde, also zB Philipp Oelwein @ HD Jochen Herz @ LU Reiner Juhser @ Fido 2:267/6652.1 Hans Dampf @ dingsdabox.zer.sub.org internet_user@cray1.rechenzentrum.uni-irgendwo.de Voreingestellt ist ADRESSEN.TXT. Kann genauso ge„ndert werden wie die Datei fr den Mailtext. 4. Die INF-Datei ist die THE_DOT-INF-Datei, aus der die Informationen ber die Pfade usw. gelesen werden. Wenn also mit THE_DOT mehrere Netze oder Accounts bedient werden, kann hier eine andere INF-Datei (auf die gleiche Weise wie oben) ausgew„hlt werden, so daž in dem Fall auch auf ein anderes SENDEN-Brett zugegriffen wird. Falls das der Fall ist, und in dieser Zeile eine andere INF-Datei ausgew„hlt wurde, sollte in den Zeilen fr die TXT-Dateien auch der entsprechende WORK-Pfad automatisch eingetragen werden. Falls nicht: bitte sofort in ziellose Panik verfallen und mir eine entsprechende Meldung zukommen lassen, damit ich ganze N„chte mit dem Debuggen zubringen kann. 5. Der Betreff Der Text, der in dieses Feld eingetragen wird, wird als Betreff fr die Serienmail verwendet. So einfach ist das. Man kann ihn auch leerlassen, dann nimmt THE_CIRCLE den Text "Heute kein Betreff" als Betreff. Die Execute-Buttons Raum und Zeit nochmal, was soll ich da noch erkl„ren??? "Absenden!" sendet und "Abbruch" tut's nicht. Punkt. Links unten ist noch ein bisher disableter Schalter namens "Verteiler" zu sehen. In einer sp„teren CIRCLE-Version kann man damit ausw„hlen, ob an jede der Serienmails noch eine Liste aller Empf„nger der bewužten Serienmail an- geh„ngt werden soll. Momentan noch Einschr„nkungen: - Betrieb nur fr MAUSnetz - L„nge der Serienmail max. 5000 Bytes - Keine Erkennung der Plausibilit„t der Adreždatei oder der Mailtext- datei. Wenn jemand glaubt, er mžte THE_CIRCLE mal mit TEX.TTP als Mailtext und mit CIRCLE.TXT als Adreždatei ausprobieren - viel Spaž! Ich bernehme keine Garantie bei Abstrzen und MsgBase-Unf„llen!! Viel Spaž also! Danksagungen: - Jochen fr THE_DOT - Wolfgang fr CoNnect - der Gatzweilers Brauerei fr Ihr_wižt_schon_was - Mendelssohn fr die Variations serieuses, op. 54 - Douglas Adams 0.95 ---- Erste ver”ffentliche Version. Nur noch 5% Fehler drin. 0.96 ---- Der aktuelle Pfad wird beim Žndern von Mailtext- oder Adreždateien ge„ndert, daher wurden relativ gesuchte Dateien (.INF) nicht wiedergefunden. Die Info-Zeile fr den Message-Ordner ist nun eine reine Anzeige-Zeile und nicht mehr zu „ndern. Nur noch 4% Fehler. 0.97 ---- An THE_CIRCLE kann als Parameter ein kompletter Pfad eines THE_DOT-INF Files bergeben werden. Auf diese Weise kann THE_CIRCLE direkt aus THE_DOT heraus aufgerufen und bedient werden. THE_DOT bergibt den Pfad des derzeit einge- stellten INF-Files. Danke, NUNZ! Diverse "Abbruch"-Auswertungen bei Fileselectorboxen werden jetzt vernnftig abgefangen. Wahrscheinlich aber immer noch nicht alle. Nach Umherschalten des aktuellen Pfades wird dieser bei Programmende wieder auf "den alten Stand gebracht". Restfehler: 3% 0.98 ---- THE_CIRCLE sucht seine Resourcedatei jetzt im aktuellen Pfad, im MODULE- und im INTERN-Ordner von THE_DOT. Fehlerhafte INF-Dateipfade werden nicht mehr durch einen Runtime Error 2, sondern durch eine Fileselectorbox abgefangen, in der ein INF-File bestimmt werden kann. Und nur noch 2% Fehler! 0.99 ---- Die Fileselectbox bei fehlerhaftem INF-Pfad bekommt man nun solange pr„sentiert, bis man Abbruch w„hlt oder eine existierende INF-Datei. Daž das auch wirklich eine THE_DOT-INF-Datei ist, darauf sollte man aber schon selbst achten! Yupiie! Nur noch 1% Fehler! Das sind immernoch 121 Bytes... Mal sehen, ob ich die nicht noch finden kann. 1.00 ---- Fr die Pfade stehen jetzt 10 Zeichen mehr zur Verfgung. (Fr die Leute, die ihre DOT-Ordnerstruktur „hnlich tief geschachtelt haben wie ich.) Und Fehler sind jetzt auch keine mehr drin. Jedenfalls weniger als Epsilon. Also ab in die Boxen damit. Geplant: -------- - Plausibilit„tsprfung fr Mailtext- und Adreždatei - Plausibilit„tsprfung fr ausgew„hlte INF-Datei - Verteiler (alle Empf„nger) in die Mail bernehmen